---
title: Use Bun com Astro
description: Aprenda como usar Bun com seu site Astro.
type: recipe
i18nReady: true
---

[Bun](https://bun.sh/) é um completo ambiente de execução e kit de ferramentas JavaScript. Veja a [documentação oficial Bun](https://bun.sh/docs) para mais informações.

:::caution
Usar Bun com Astro pode revelar alguns casos extremos. Algumas integrações podem não funcionar como esperado. Consulte a [documentação oficial Bun para trabalhar com Astro](https://bun.sh/guides/ecosystem/astro) para detalhes.

Se você tiver problemas usando Bun, por favor [abra uma issue diretamente no GitHub de Bun](https://github.com/oven-sh/bun/issues/new/choose).
:::

## Pré-requisitos

- Bun instalado localmente na sua máquina. Veja as [instruções de instalação](https://bun.sh/docs/installation) na documentação oficial Bun.

## Criar um novo projeto Astro com Bun

Crie um novo projeto Astro com Bun usando o seguinte comando `create-astro`:

```bash
bunx create-astro@latest my-astro-project-using-bun
```

:::tip
Você também pode [criar um novo projeto Astro a partir de qualquer repositório Astro existente no GitHub](/pt-br/install-and-setup/#use-um-tema-ou-um-modelo-inicial) usando a marcação `--template`:
```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```
:::

## Instalar dependências

Se você está iniciando um novo projeto com `bunx create-astro`, a CLI usará automaticamente o Bun para instalar as dependências, e você pode pular esta etapa.

Caso contrário, será necessário instalar suas dependências com Bun:

```bash
bun install
```

## Adicionar Tipos

Bun publica o pacote [`@types/bun`](https://www.npmjs.com/package/@types/bun), que contém os tipos de tempo de execução para Bun.

Instale `@types/bun` usando o seguinte comando:

```sh
bun add -d @types/bun
```

## Usar integrações do Astro

Você pode usar qualquer uma das integrações oficiais do Astro com o comando `astro add`:

```bash
bunx astro add react
```

## Executar Astro com Bun

:::note
Use a [marcação `--bun` na CLI](https://bun.sh/docs/cli/bunx#shebangs) antes de cada comando `astro` para usar o próprio ambiente de execução Bun em vez do Node.
:::

### Executar o servidor de desenvolvimento

Para executar o servidor de desenvolvimento usando o Bun como ambiente de execução, use o seguinte comando:

```bash
bunx --bun astro dev
```

### Construir seu site com Bun

Para construir seu site usando o Bun como ambiente de execução, use o seguinte comando:

```bash
bunx --bun astro build
```

Astro gerará o seu site no diretório `dist/`. Em seguida, você pode servir seu site usando o comando `preview`:

```bash
bunx --bun astro preview
```

## Adicionar SSR com Bun

Como Bun possui [compatibilidade com a API Node.js](https://bun.sh/docs/runtime/nodejs-apis), você pode usar qualquer adaptador Astro para [renderização no lado do servidor](/pt-br/guides/on-demand-rendering/) em seu projeto Astro:

```bash
bunx astro add vercel
```

## Testando no Bun

Bun vem com um executor de testes integrado, rápido e compatível com Jest, através do comando `bun test`. Se você quiser usá-lo, leia a [documentação `bun test`](https://bun.sh/docs/cli/test).

No entanto, também é possível usar Cypress ou Playwright para uma abordagem moderna de testes para aplicativos web.

### Cypress

Cypress é uma ferramenta de testes front-end que tem a missão de "tornar a experiência de teste agradável e gerar felicidade para os desenvolvedores". Isso permite que você escreva testes de ponta a ponta para o seu site Astro.

Instale Cypress com o seguinte comando:

```bash
bun add cypress --dev
```

Para o restante da configuração e para iniciar seu primeiro teste, siga o processo completo do Cypress no [Guia de Testes Astro](/pt-br/guides/testing/#configuration).

### Playwright

Playwright é um framework de testes de ponta a ponta que permite testar seu código Astro em todos os motores de renderização modernos, incluindo Chromium, WebKit e Firefox.

Instale o Playwright usando o seguinte comando:

```bash
bun create playwright
```

Para criar seu primeiro teste Playwright, siga as instruções no [Guia de Testes Astro](/pt-br/guides/testing/#create-your-first-playwright-test).

## Recursos Oficiais

- [Crie uma aplicação com Astro e Bun](https://bun.sh/guides/ecosystem/astro)

## Recursos da Comunidade

Usando Bun com Astro? Adicione sua postagem ou vídeo nesta página!

- [Construindo um site Cloudflare Pages com Bun](https://blog.otterlord.dev/posts/hello-from-bun/) - postagem de blog
